home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 228 (1992-12-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 228 (1992-12-10)(Manewaldt, A.)(DE)(PD).adf / ak_gen0-Library / AK_GEN0-Lib_ENG.doc < prev    next >
Text File  |  1992-12-01  |  9KB  |  256 lines
  1. ==============================================================================
  2. ==============================================================================
  3. ===                    ak_gen0.library V35.106 rel. 0307-92                ===
  4. ==============================================================================
  5. ===                           ( F R E E W A R E)                           ===
  6. ==============================================================================
  7. ===                  (Next generation of the "ak.library")                 ===
  8. ==============================================================================
  9. ===                                                                        ===
  10. ===                       (c) 1989-92 by Andreas Ralph Kleinert            ===
  11. ===                                      Grube Hohe Grethe 23              ===
  12. ===                                      W-5900 Siegen 1                   ===
  13. ===                                      Germany                           ===
  14. ===                                                                        ===
  15. ==============================================================================
  16. ==============================================================================
  17.  
  18.     The "ak_gen0.library" is FREEWARE and therefore freely distributable.
  19.  
  20.     The free distribution of the "ak_gen0.library" is allowed, if only a small
  21.     copy-fee is taken and no profit is made.
  22.  
  23.     The "ak_gen0.library" is used in many of my programs and it consists of
  24.     many functions, which make programming much easier (e.g. the programming
  25.     of "Intuition").
  26.  
  27.     This docfile has to be distributed with EVERY copy of the "ak_gen0.library"
  28.     to inform all user about the restrictions made here.
  29.  
  30.     The "ak_gen0.library" may be used for own program projects, if those
  31.     are PUBLIC DOMAIN or FREEWARE.
  32.  
  33.     Programmers of SHAREWARE, which charge a share-fee higher than 20,-DM
  34.     (or $15), or programmers of commercial programs have to get the explicite
  35.     permission of the author (me) to use the library. Contact me to get
  36.     informed about my conditions.
  37.  
  38.                    --- Docfileversion A-V35.106-0307-92 ---
  39.  
  40. =============================================================================
  41. = INSTALLATION :                                                            =
  42. =============================================================================
  43.  
  44.     Copy the "ak_gen0.library" into your "LIBS:"-directory.
  45.  
  46. =============================================================================
  47. = FUNCTIONS :                                                               =
  48. =============================================================================
  49.  
  50.     The "ak_gen0.library" consists of ...
  51.  
  52.      - Functions for comfortable opening of Windows and Screens
  53.      - Functions for simple creation of Gadgets, Menus, Submenus,
  54.        Images, etc.
  55.      - Functions for simple print-out of Texts
  56.      - a easy to handle Filerequester, which is completely managed by the
  57.        Library.
  58.        Under OS >= V2.04 the Asl-Filerequester is used instead.
  59.        Both FileRequesters are nearly "function-compatible".
  60.      - a random-number generator
  61.      - Functions to wait for special events as "Left Mousebutton pressed"
  62.        or "Key ??? pressed"
  63.      - etc.
  64.  
  65.    Read the file "AK_GEN0-Lib_Reference.doc", to get a full description of its
  66.    functions.
  67.  
  68. =============================================================================
  69. = VERSION-"HISTORY" :                                                       =
  70. =============================================================================
  71.  
  72. -----------------------------------------------------------------------------
  73. - Versions of the "ak_gen0.library" (Starting with V34.00) :                -
  74. -----------------------------------------------------------------------------
  75.  
  76.     AK_GEN0-V35.106 :
  77.     -----------------
  78.  
  79.      - Filerequester (OS V1.3) : Softrefresh-Routine for another two
  80.                                  Gadgets (were not refreshed ;
  81.                                           display was not correct)
  82.  
  83.  
  84.     AK_GEN0-V35.105 :
  85.     -----------------
  86.  
  87.      - Filerequester (OS V1.3) : Softrefresh-Routine for Gadgets
  88.  
  89.  
  90.     AK_GEN0-V35.102 :
  91.     -----------------
  92.  
  93.      - Elemination of a compatibility problem in the "AK_ReadDir()"-
  94.        Routine
  95.      - Fixed a bug in the "AK_RefreshDisp()"-Routine, which could cause
  96.        a GURU in connection with some programs
  97.        (from V35.99)
  98.  
  99.  
  100.     AK_GEN0-V35.101 :
  101.     -----------------
  102.  
  103.      - Fixing of a fatal Error in the OS-V1.3-FileRequester
  104.        (Directory-Recognition)
  105.  
  106.  
  107.     AK_GEN0-V35.99 :
  108.     ----------------
  109.  
  110.      - improvement of AK_RefreshDisp()
  111.        (Screen is now completely cleaned, then ShowTitle() is called)
  112.      - improvement of path-creation in AK_FileRequest()
  113.      - Fixing of a fatal Error in the OS-V1.3-FileRequester
  114.  
  115.  
  116.     AK_GEN0-V35.98 :
  117.     ----------------
  118.  
  119.      - completely new FileRequester under OS 1.3, which has the OS V2.04-Look
  120.        and is "function-compatible" to the Standard-Asl-Filerequester.
  121.        (without WildCards).
  122.        The good :
  123.                    - Standard-Selectbox (Prop-Gadget, Scroll-Gadgets)
  124.                    - separate O.K. / Cancel-Gadgets
  125.                    - Parent-Gadget
  126.                    - Assigns-Gadget
  127.  
  128.  
  129.     AK_GEN0-V35.25 :
  130.     ----------------
  131.  
  132.      - Filerequester now with functionable Prop-Gadget
  133.      - small bug of the Filerequester fixed (there weren't always 256 Bytes
  134.        reserved for the FileName-String)
  135.      - misc things in the Doc-File fixed
  136.      - and more ...
  137.      - "ExpungeLib" now works without bugs
  138.  
  139.  
  140.     AK_GEN0-V35.21 :
  141.     ----------------
  142.  
  143.      - now with full description of all Functions and their Include-Files
  144.        (for SAS/C V5.10a/b)
  145.      - small bug in "AK_ReadDir" fixed.
  146.  
  147.  
  148.     AK_GEN0-V35.16 :
  149.     ----------------
  150.  
  151.      - memory allocation / delocation improved in the (internal) FileRequester
  152.      - changes in the Include-File
  153.  
  154.  
  155.     AK_GEN0-V35.15 :
  156.     ----------------
  157.  
  158.      - If used under OS >= V2.04 the "asl.library" will be used for the
  159.        FileRequester (its just better ...)
  160.      - some small bug fixes and expansions
  161.      - improved "compatibility" with the OS V2.04-Includes
  162.  
  163.  
  164.     AK_GEN0-V35.2 :
  165.     ---------------
  166.  
  167.      - improved the FileRequester, now V34.2
  168.      - FileRequester now presented in the 3-D-Look of the Workbench V2.04
  169.        (partially)
  170.        (only, if the current screen uses the new colors of OS >= V2.04)
  171.      - memory allocation / delocation improved
  172.  
  173.  
  174.     AK_GEN0-V34.01 :
  175.     ----------------
  176.  
  177.      - renamed to "ak_gen0.library" (reasons mentioned above)
  178.      - improved the FileRequester, now V34.01
  179.      - more error-checks
  180.      - Codeoptimizations (now even shorter)
  181.      - "Killing" of more or less unused functions
  182.        (incompatibility to the "ak.library", that's why a new name was
  183.         needed.)
  184.  
  185. -----------------------------------------------------------------------------
  186. - Versions of the "ak.library" (The generation before) :                    -
  187. -----------------------------------------------------------------------------
  188.  
  189.     AK-V34.12 :
  190.     -----------
  191.  
  192.      - changed the Library-Structure (Resident-Part, Init-Routine, etc.)
  193.      - improved the FileRequester, now V2.01
  194.        (for example there are only those Gadgets refresht, which actually
  195.         have to be -> this results in less "flickering")
  196.      - improved error-handling (no longer Alerts, but NULL-returns)
  197.      - more error-checks
  198.      - Codeoptimizations (only about 10000 CodeLength left)
  199.  
  200.  
  201.     AK-V34.10 :
  202.     -----------
  203.  
  204.      - complete "reprogrammed" FileRequester, now in version V2.00
  205.        with "End"-Gadget and Volume-Gadgets
  206.      - correction of the random-number routine
  207.        (Bug, which occured after rewrote in V34.01)
  208.  
  209.  
  210.     AK-V34.01 :
  211.     -----------
  212.  
  213.      - some small bug fixes
  214.  
  215.  
  216.     AK-V34.00 :
  217.     -----------
  218.  
  219.      - strongly expanded version
  220.      - more functions
  221.      - Filerequester
  222.  
  223.  
  224.     AK-V33.01 :
  225.     -----------
  226.  
  227.      - first non-prerelease-version
  228.        (rel. 2801-91 with small bug, which has been fixed in rel. 0303-91.)
  229.  
  230. ------------------------------------------------------------------------------
  231. ------------------------------------------------------------------------------
  232.  
  233.    Known bugs :
  234.  
  235.    - There are no (known) bugs.
  236.      (For known bugs of the "ak_gen0.library", look into its Docfile !)
  237.  
  238. ------------------------------------------------------------------------------
  239. ------------------------------------------------------------------------------
  240.  
  241.    Possible enhancements in future versions :
  242.  
  243.   - more internal optimizations
  244.   - more expandements of the function value
  245.   - bug-fixing
  246.     (send me BUG-reports !!!)
  247.  
  248. =============================================================================
  249. = COPYRIGHTS :                                                              =
  250. =============================================================================
  251.  
  252. =============================================================================
  253. =   Copyrights of other mentioned products/programs are to find in the      =
  254. =   manuals of these and are not listed explicitely at this place here.     =
  255. =============================================================================
  256.